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about this guide 



This installation guide supersedes previous Business Copy (BC) host agent installation guides 
and provides information to help you: 

■ Understand BC host agent installation prerequisites 

■ Install BC host agent for Linux software on a host computer in a BC network 

■ Reinstall BC host agent software on a host computer 

■ Remove BC host agent software from a host computer 

■ Contact technical support for additional assistance 
"About this Guide" topics include: 

■ Overview, page 6 

■ Conventions, page 7 

■ Getting help, page 8 
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About this Guide 



Overview 

This section covers the following topics: 

■ Intended audience 

■ Prerequisites 

Intended audience 

This guide is intended for customers and HP authorized service providers. In addition to being 
familiar with BC, readers should also be knowledgeable of BC-supported: 

■ SAN fabric configurations 

■ Host operating system environments 

■ Storage systems 

■ Multibus configurations 

Prerequisites 

Before installing BC host agent software, consider the following items: 

■ Has the BC server software been installed on a BC server platform? 

If not, install the BC server software before continuing. Refer to the HP StorageWorks 
Business Copy EVA/MA/EM A v2.3 Getting Started Guide 1 (AA-RVHRA-TE) for 
prerequisite information and the HP StorageWorks Business Copy EVA/MA/EMA 2.3 
Server Installation Guide (T3032-96202) for the installation procedure. 

■ Does the host computer on which the BC host agent software is being installed have 
visibility to a BC server platform in the same SAN environment? If not, refer to the HP 
StorageWorks Business Copy EVA/MA/EMA 2.3 Network Administration Guide 2 
(T3032-96301). 
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1 . Hereafter referred to as BC Getting Started Guide. 

2. Hereafter referred to as BC Network Administration Guide. 
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Conventions 

Conventions consist of the following: 

■ Document conventions 

■ Text symbols 

Document conventions 



This document follows the conventions in Table 1. 
Table 1 : Document conventions 



Convention 


Element 


Blue text: Figure 1 


Cross-reference links 


Bold 


Menu items, buttons, and key, tab, and box 
names 


Italics 


Text emphasis and document titles in body text 


Monospace font 


User input, commands, code, file and 
directory names, and system responses (output 
and messages) 


Monospace, italic font 


Command-line and code variables 


Blue underlined sans serif font text 

(http://www.hp.com) 


Web site addresses 



Text symbols 

The following symbols may be found in the text of this guide. They have the following 
meanings: 



WARNING: Text set off in this manner indicates that failure to follow directions in the 
/ J \ warning could result in bodily harm or death. 



A Caution: Text set off in this manner indicates that failure to follow directions could result in 
damage to equipment or data. 



Tip: Text in a tip provides additional help to readers by providing nonessential or optional 
techniques, procedures, or shortcuts. 



Note: Text set off in this manner presents commentary, sidelights, or interesting points of 
information. 
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About this Guide 



Getting help 



If you still have a question after reading this guide, contact an HP authorized service provider 
or access our web site: http:/ / www.hp.com . 



HP technical support 



Telephone numbers for worldwide technical support are listed on the following HP web site: 
http://www.hp.com/ support/ . From this web site, select the country of origin. 



Note: For continuous quality improvement, calls may be recorded or monitored. 

Be sure to have the following information available before calling: 

■ Technical support registration number (if applicable) 

■ Product serial numbers 

■ Product model names and numbers 

■ Applicable error messages 

■ Operating system type and revision level 

■ Detailed, specific questions 



HP storage web site 



The HP web site has the latest information on this product, as well as the latest drivers. Access 
storage at: http://www.hp.com/ country/ us/eng/ prodserv/storage.html . From this web site, 
select the appropriate product or solution. 



HP authorized reseller 



For the name of your nearest HP authorized reseller: 

■ In the United States, call 1-800-345-1518 

■ In Canada, call 1-800-263-5868 

■ Elsewhere, see the HP web site for locations and telephone numbers: http:/ / www.hp.com . 
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Installation Preparation 




This chapter provides preparation information for installing BC host agent software. Refer to 
the BC Getting Started Guide for prerequisite information before installing BC. 

Complete the installation preparation before beginning a BC host agent software installation. 



Caution: Do not install the BC host agent before reviewing the BC server platform 
configuration. Installing BC in an unsupported configuration may cause the BC network to 
function improperly. For procedures on planning and verifying BC supported configurations, 
refer to the BC Network Administration Guide. 
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Installation Preparation 



New installation preparation 

Complete the following procedures before installing BC: 

■ Coordinating Business Copy installation activities 

■ Verifying the Business Copy server configuration 

■ Verifying the host configuration 

Coordinating Business Copy installation activities 

Before installing BC, ensure that: 

■ The BC host agent installation activities have been coordinated with users of the host; 
coordinating with other users prevents a disruption in host activities 

■ The BC host agent version being installed is compatible with the BC server for this BC 
network 

■ The BC server that supports the BC host agent installation is installed or updated before 
installing the BC host agent 

■ The BC server is running while installing the BC host agent 



Note: HP strongly recommends that the BC server be running to allow the BC host agent installation 
software to establish communication with the BC server. If necessary, the BC host agent can be 
installed without the BC server running. 



Verifying the Business Copy server configuration 

Before installing the BC host agent, verify that the BC server: 

■ Has a version level that supports this host agent 

■ Remains running during the host agent update 

Also, record the following BC server platform information for the BC host agent installation: 

■ Fully qualified network name (such as MyComputer.dept.corp) 

■ Unqualified network name (such as MyComputer) 

■ IP address (such as 1 1.22.33.44) 

Make this information available during the BC host agent installation. 

To view the network name and IP address of a BC server platform, browse to the BC server 
platform and log in. Both items are shown at the top of the home page. 

When ready, go to the next section. 

Verifying the host configuration 

Before installing the BC host agent, verify that the host has BC-supported configurations and 
versions of the following: 

■ Host operating system version 

■ StorageWorks Solution Software kit 

■ FC HBAs and drivers 
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■ StorageWorks Secure Path 

■ Multibus failover configuration with the storage controllers 

This BC host agent is not cluster-aware, but can co-exist with HP Serviceguard for Linux 
clusters. 

Refer to the BC Network Administration Guide and HP StorageWorks Business Copy 
EVA/MA/EMA 2.3 Host Agent for Linux Release Notes 1 (T3032-98008) for specific 
requirements. 

Visit http:/ /hi 8000. wwwl .hp.com/ products/storage/software/bizcopyeva/index.html for 
updated BC documentation and software. 

When ready, go to "Installing the Business Copy Host Agent" on page 13 to start the 
installation. 



1 . Hereafter referred to as BC Host Agent Release Notes. 
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Installing the Business Copy 
Host Agent 




This module assumes that "Installation Preparation" on page 9 has been read and all 
appropriate steps have been successfully completed. Complete the following procedures, in 
sequence, to install a BC host agent: 

1. Preparing for installation, page 14 

2. Starting the installation, page 15 

3. Completing the installation, page 29 
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Installing the Business Copy Host Agent 



Preparing for installation 

Complete the following procedure to install the BC host agent software. 



Note: To install BC successfully, the host computer must have at least 66 MBs of free disk space. 



CD-ROM method 

1. Locate the BC host agent CD-ROM. 

2. On the host computer, open a terminal window and log on as a super-user. 

3. Insert the CD-ROM into the CD drive. 

An auto-run feature begins, extracting the BC host agent files to a default temporary folder 
on the host computer. After the files are extracted, setup begins. 

4. Navigate to the folder on the CD-ROM containing the Linux files 
(. . . /bc_23_linux_ha_install). 

When ready, go to "Stalling the installation" on page 15. 

Web download method 

1. Locate either the CD-ROM made from the BC download or the download file on the host 
computer. 

2. Unzip the download file. 

3. Locate and copy the bc_23_linux_install_ha . bin file to the host computer. 

4. On the host computer, navigate to the folder containing the 
bc_23_linux_install_ha . bin file and extract the files. 

5. Locate the bc_23_ha_linux_install.bin file on the host computer. 
This file initiates the BC host agent installation. 

When ready, go to "Starting the installation" on page 15. 
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Starting the installation 

BC provides two installation methods for Linux: command console and GUI. 



Note: The BC host agent installation script needs another application on the host computer to 
register BC with the local installer. This application is called Red Hat Package Manager (RPM) 
Builder. HP recommends installing RPM Builder (for example, 32-bit hosts require: 
rpm-build-4 . 2 . 1-4 . 2 . i386 . rpm) on the host computer before installing the BC host agent. 
HP does not recommend installing RPM Builder on systems that do not typically use RPM because 
serious issues might occur. 

Unavailability of RPM Builder does not prohibit the BC host agent installation, but does prohibit BC 
from being registered on the host computer. On platforms that use RPM for installation management, 
BC becomes registered with the RPM database; however, do not use RPM to manage the installation. 



Command console installation method 

Complete the following procedure to install the BC host agent software. 



Note: During the installation procedure, press Enter to choose the default response. To return to a 
previous step, enter back. To exit the installation script at any time, enter quit. 



Note: Do not remove the BC host agent CD-ROM from the CD drive until the installation is complete. 
Removing the CD-ROM before the installation is complete may cause the installation to fail or BC to 
function improperly. 



1. Enter sh . /bc_23_linux_ha_install . bin to start the installation. 

General information displays as the installation script unpacks, followed by BC-specific 
information. 



Note: Unpacking of the Java™ Runtime Environment (JRE) software segment can take 3-5 minutes. 
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Installing the Business Copy Host Agent 



Preparing to install. . . 

Extracting the JRE from the installer archive... 
Unpacking the JRE . . . 

Extracting the installation resources from the installer archive... 
Configuring the installer for this system's environment... 

Launching installer. . . 

Preparing CONSOLE Mode Installation 

Business Copy Host Agent (created with Ins tall Anywhere by Zero G) 



Introduction 

InstallAnywhere will guide you through the installation of Business Copy (BC) . 

HP strongly recommends that you use an account with "super-user" or "administrator" 
privileges before executing this installation script. If you are not logged in as root, 
quit this install, log into the root account and execute this installation script again. 

Respond to each prompt to proceed to the next step in the installation. If you want to 
change something on a previous step, enter 'back'. 

You may cancel this installation at any time by entering 'quit'. 

PRESS <ENTER> TO CONTINUE: 

Figure 1 : Initiating the installation script 

2. Press Enter to continue. 

3. Review the BC license agreement and answer the question at the end. 
Press Enter as necessary to scroll through the license agreement. 

BC License Agreement 

Installation and use of Business Copy v2 . 3 Host Agent requires acceptance of the 
following License Agreement: 

Business Copy EVA/MA/EMA License Agreement 

Attention Notice 

IMPORTANT: READ CAREFULLY BEFORE USING THIS PRODUCT. 

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N) : 

Figure 2: License agreement 

4. Enter y or yes to agree to these terms and continue the installation; enter n or no to 
exit the installation script. 

Entering yes provides a list of BC prerequisites. 

Note: HP recommends exiting the installation if BC prerequisites have not been met or if doubts exist 
as to whether the requirements are met. Take the necessary action to make sure that these 
prerequisites are met and restart the installation. 



16 



Business Copy EVA/MA/EMA 2.3 Host Agent for Linux Installation Guide 



Installing the Business Copy Host Agent 



BC Prerequisites 

Please read before continuing: 
Do not proceed until you have: 

- Read the HP StorageWorks BC Network Administration Guide, BC Server Installation Guide, 

CAUTION: Failure to properly address BC preinstallation requirements and compatibility 
considerations can lead to reduced operational capability and failure of BC jobs. 

PRESS <ENTER> TO CONTINUE: 

Figure 3: BC Prerequisites 

5. Carefully review the list of BC prerequisites and make sure each item has been addressed 
before continuing the BC host agent installation. 

Note: If any of the operational considerations have not been addressed, exit the installation, 
address the items, and then restart the installation. 



6. Press Enter to continue; enter quit to exit the installation script. 
An option to select the BC installation folder displays. 

■ For initial installations, /opt/ displays as the BC default installation folder. 

■ For reinstallations, the actual folder used during the previous installation displays as 
the default installation folder. 



Note: If a previous BC installation exists on this host computer with customized osvm. ini 
attribute settings, HP recommends saving the osvm. ini file to an alternate location. Then, 
following the BC installation, use this saved file to reapply the customized attribute settings to the new 
osvm. ini file, if desired. 



Choose Install Folder 

Choose the base path you wish to install to. The files will be installed to a 
subdirectory "CPQevm" of the path chosen. 

Where would you like to install Business Copy 

Default Install Folder: <BC_default_or_previous_folder> 

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 

Figure 4: Installation folder option 

7. Press Enter to continue using the BC default installation folder or enter an absolute path 
to the desired installation folder; enter quit to exit the installation script. 

After determining the installation folder, the BC host agent software installation begins. 
Initially, a progress bar is displayed, followed by an BC server platform question. 
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Installing the Business Copy Host Agent 



Note: For reinstallations, the previous BC server platform name displays as the default. 



BC Server Platform Name 

Enter the BC server platform fully qualified name, unqualified name, or IP address: 
BC server platform Name: (DEFAULT: <BC server vlatform name/IP>) : 

Figure 5: BC Server Platform Name option 

8. Enter the fully qualified name, unqualified name, or IP address of the BC server platform 
that supports this BC host agent. 



Note: The BC server platform name is required to establish network communication between BC 
host agents and the BC server. 



For example: 

■ If the BC server platform name is "MyAppliance" and the domain is "dept.com," enter 
My Appliance . dept . com for a fully qualified name. 

■ If the fully qualified name is MyAppliance . dept . com, enter MyAppliance 
as the unqualified name. 

■ IftheBC server platform IP address is "11.22.33.44," enter 11.22.33.44 for the 
IP address. 

After entering the BC server platform name or IP address, a check is performed to verify 
communication. This check allows an incorrect BC server platform name to be corrected 
and also provides the opportunity to continue the BC host agent installation in the event 
that the LAN is down or the BC server platform is offline. 



■ If this check fails, Figure 


6 displays. 




Unable To Ping Host 




Unable to ping the BC server platform on 
name to the sb.ini file at a later date, 
and continue the installation? 


this network. You can add the BC server platform 
Do you want to keep this BC server platform name 


->1- Yes 
2- No 




ENTER THE NUMBER OF THE DESIRED CHOICE, 


OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 



Figure 6: Unsuccessful ping to the BC server platform 

— Entering a 1 continues the installation using the BC server platform name 
entered in step 9. 

— Entering a 2 displays Figure 5 and continues the installation. 

Select the platform name option that best fits the installation situation and continue the 
installation. Selecting Yes allows the setup to continue in the event that the LAN is 
down or the BC server platform is offline. 

■ If this check succeeds, Figure 7 displays. 
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Start BC Daemons 

Would you like to start the BC Daemons after the installation is complete? If you are 
unsure as to whether or not to start the BC Daemons after the installation, please refer 
to the BC Network Administration Guide. 

->1- Yes 

2- No 

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 

Figure 7: Start BC Daemons 

9. Enter y or yes to agree to start the BC daemons; enter n or no to defer starting the 
BC daemons. 

Refer to the Network Administration Guide for more information on starting and stopping 
BC daemons. 



Pre-Installation Summary 

Please Review the Following Before Continuing: 

Product Name: 

Business Copy Host Agent 

Install Folder: 

<selected_f older or /opt> 

BC server platform: 

<BC_server_platform_name/IP> 

Disk Space Information (for Installation Target) : 
Required: 66,044,976 bytes 
Available: 123,456,789 bytes 

PRESS <ENTER> TO CONTINUE: 



Figure 8: Pre-Installation Summary 

10. Press Enter to continue; enter quit to exit the installation. 
The BC host agent software installation takes place. 





Additional Information 




To reinstall or remove the Business Copy 
BC Host Agent Installation Guide. 


software from this host computer, refer to the 


Please consult the BC Host Agent Release 


Notes before using Business Copy. 


To submit comments regarding BC, send an 


email to BCFeedback@hp.com. 


PRESS <ENTER> TO CONTINUE: 




Figure 9: Additional Information 



1 1 . Carefully review the Additional Information provided. 

12. Press Enter to continue. 
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Installing the Business Copy Host Agent 



Installation Complete 

Congratulations. Business Copy v2 . 3 Host Agent has been successfully installed to: 
<selected_f older or /opt> 

PRESS <ENTER> TO EXIT THE INSTALLER: 

Figure 10: BC host agent installation completion 

13. Press Enter to complete the installation. 

The BC host agent software is installed. This new BC-enabled host can now communicate 
with the BC server and participate in BC jobs. Refer to the BC Host Agent Release Notes 
before using BC. 

GUI installation method 

Complete the following procedure to install the BC host agent software. 



Note: If installing BC in GUI mode, set the host computer color depth to at least 256 colors. 



Note: Do not remove the BC host agent CD-ROM from the CD drive until the installation is complete. 
Removing the CD-ROM before the installation is complete may cause the installation to fail or BC to 
function improperly. 



1. On the host computer, open a terminal window and log on as a super-user. 

2. Enter . /bc_23_linux_ha_install . bin -i gui to start the installation. 
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^ Business Copy EVA/MA/EMA Host Agent v2.3 



n Introduction 

■ BC License Agreement 

■ BC Prerequisites 

■ Choose Install Folder 

■ Storage Management Pla.. 

■ Host Cluster 

■ Pre-lnstallation Summary 

■ Installing... 

■ Additional Information 

■ Install Complete 



InstallAnywhere by Zero G ■ 
Cancel 



Introduction 



InstallAnywhere will guide you through the installation of HP 
StorageWorks Business Copy (BC). 

HP strongly recommends that you use an account with super-user or 
administrator privileges before executing this installation script. If you 
are not logged in as root, quit this install, log into the root account and 
execute this installation script again. 

It is strongly recommended that you quit all programs before 
continuing with this installation. 

Click the 'Next' button to proceed to the next screen, If you want to 
change something on a previous screen, clickthe 'Previous' button. 

You may cancel this installation at anytime by clicking the 'Cancel' 
button. 



Previous 



Next 



Figure 1 1 : Introduction 



Note: Click Cancel at any time to exit the installation. 



3. Click Next. 
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*e Business Copy EVA/MA/EMA Host Agent v2.3 



" Introduction 

n BC License Agreement 

■ BC Prerequisites 

■ Choose Install Folder 

■ Storage Management Pla.. 

■ Host Cluster 

■ Pre-lnstallation Summary 

■ Installing... 

■ Additional Information 

■ Install Complete 



InstallAnywhere by Zero G ■ 
Cancel 



BC License Agreement 



Installation and Use of Business Copy Host Agent Requires 
Acceptance of the Folio wing License Agreement: 



Business Copy EVA/MA/EMA License Agreement 
Attention Notice 

IMPORTANT: READ CAREFULLY BEFORE USING THIS 
PRODUCT. 

USE OF THE SOFTWARE IS SUBJECT TO THE 
HEWLETT-PACKARD COMPANY ("HP") SOFTWARE LICENSE 
TERMS SET FORTH BELOW. USE OF THE SOFTWARE 
INDICATES YOUR ACCEPTANCE OF THESE LICENSE TERMS. 
IF YOU DO NOT ACCEPT THESE LICENSE TERMS, YOU MUST 
NOT INSTALL THE SOFTWARE. 

(* 1 ao tfpt thi? t~rTTi/ th* Ui-rife ^--m^rit 

C I do HOT accept the terms of the License Agreement 



"3 



Previous 



Next 



Figure 1 2: BC License Agreement 

4. Carefully review the BC License Agreement terms before continuing with the installation. 



Note: To continue installing the BC host agent software, the terms in the agreement must be 
accepted. 



5. Click I accept the terms of the License Agreement to continue the installation. 

6. Click Next. 

Review these prerequisites and become familiar with each one. This window provides a 
reminder of items to verify or perform before continuing the BC host agent installation. 
Refer to the BC Getting Started Guide for detailed prerequisite information. 



Note: If these prerequisites have not been met, or doubts exist as to whether the prerequisites are 
met, HP recommends clicking Cancel to exit the installation. Then, take the necessary action to make 
sure that the prerequisites are met and restart the installation. 
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BC Prerequisites 



Introduction 

BC License Agreement 
W BC Prerequisites 

■ Choose Install Folder 

■ BC Server Platform Name 

■ Host Cluster 

■ Pre-lnstallation Summary 

■ Installing... 

■ Additional Information 

■ Install Complete 



Please Read Before Continuing: 



Do not proceed until you have: 

- Read the HP StorageWorks BC Network. 
Administration Guide, BC Getting Started Guide, BC 
Server Installation Guide, BC Host Agent 
Installation Guide, BC Server Release Notes, and BC 
Host Agent Release Notes. 

- Addressed all (BC) preinstallation requirements 
and compatibility considerations. 

Typical items to address before installing a BC 
host agent include: 

- Host Operating System Version 

- StorageWorks Solution Software Kit version 

- Fibre Channel Host Bus Adapters (HBA) and Driver 
versions 



InstallAnywhere by Zero G ■ 
Cancel 



Previous 



Next 



Figure 13: BC Prerequisites 

7. If the prerequisites are met, click Next. 
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Choose Install Folder 



" Introduction 

BC License Agreement 

BC Prerequisites 
n Choose Install Folder 

■ Storage Management Pla.. 

■ Host Cluster 

■ Pre-lnstallation Summary 

■ Installing... 

■ Additional Information 

■ Install Complete 



Where would you like to install Business Cony? 
I /*>Pt 



Restore Default Folder 



Choose.. 



InstallAnywhere by Zero G ■ 
Cancel 



Figure 14: Choose Install Folder 



Previous 



Next 
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Click Next if the default destination folder is acceptable; otherwise, click Choose to 
browse to another installation folder and then click Next. 
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"' Introduction 

BC License Agreement 
BC Prerequisites 
Choose Install Folder 

" BC Server Platform Name 

■ Host Cluster 

■ Pre-lnstallation Summary 

■ Installing... 

■ Additional Information 

■ Install Complete 



Enterthe BC server platform fully qualified name, unqualified name, 
or IP address: 



BC Server Platform Name: 



InstallAnywhere by Zero G • 
Cancel 



Previous 



Next 



Figure 1 5: BC Server Platform Name 



Note: For reinstallations, the previous BC server platform name displays as the default. 



9. Enter the fully qualified name, unqualified name, or IP address of the BC server platform 
that supports this BC host agent. 

Note: HP recommends using the fully qualified name when entering BC server platform name 
information. The BC server platform name is required to establish network communication between 
this BC host agent and the BC server. 



10. Click Next. 

A check is performed to verify communication. This check allows an incorrect BC server 
platform name to be corrected and also provides the opportunity to continue the BC host 
agent installation in the event that the LAN is down or the BC server platform is offline. 

■ If this check fails, Figure 16 displays. 
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Destination Unreachable 



<3> 



Unable to ping host: "" 

U n a b I e to pingthe Storage Management Appliance o n th is n etwo rk. 
You can add the Storage Management Appliance name to the 
sb.ini file at a later date. Do you want to keep this Storage 
Management Appliance name and continue the installation? 



Mo 



I Yes j| 



Figure 16: Unable to ping BC server platform failure message 

— Click Yes to continue the installation using the BC server platform name entered 
in step 9. 

— Click No to display Figure 15 and continue the installation at step 9. 
■ If this check succeeds, Figure 17 displays. 



Start BC Daemons 



Stan BC Daemons 

Would you like to start the BC daemons afterthe installation is 
complete? If you are unsure as to whether or not to start the BC 
daemons afterthe installation, please referto the BC Network 
Administrator Guide. 



No 



Yes 



Figure 1 7: Start BC Daemons 

11. Click Yes to start BC daemons; click No to defer BC daemons. 
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^2 Business Copy EVA/MA/EMA Host Agent v2.3 



•Jnjxj 



Pre-lnstallation Summary 



n Introduction 

"' BC License Agreement 
BC Prerequisites 
Choose Install Folder 
Storage Management Pla.. 

~ Host Cluster 

R Pre-lnstallation Summary 

■ Installing... 

■ Additional Information 

■ Install Complete 



InstallAnywhere by Zero G ■ 
Cancel 



Please Review the Following Before Continuing: 



Product Name: 

Business Copy Host Agent 

Install Folder: 

/opt 

BC Server Platform: 



Disk Space Information (for Installation Target): 

Required: 42,784,314 bytes 
Available: 14,344,925,184 bytes 



Previous 



Install 



Figure 18: Pre-installation Summary 

12. Review the summary information. 

13. If the summary information is: 

■ Not correct, click Previous or Cancel. 

■ Correct, click Install. 

An installation progress window briefly displays as the BC host agent software 
installs. 
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^ Business Copy EVA/MA/EMA Host Agent v2.3 



n Introduction 

BC License Agreement 

BC Prerequisites 
,w ' Choose Install Folder 
^ Storage Management Pla.. 
" Host Cluster 

Pre-lnstallation Summary 

Installing... 
1-1 Additional Information 
■ Install Complete 



__Jn|2<| 
Additional Information 



To reinstall or remove the Business Copy software from the host 
computer, referto the 
BC Host Agent Installation Guide. 

Please consult the BC Host Agent Release Notes before using 
Business Copy. 

To submit comments regarding BC, send an email to 
BCFeedback@hp.com 



InstallAnywhere by Zero G ■ 
Cancel 



Previous 



Next 



Figure 19: Additional Information 

14. Click Next. 
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'~' Introduction 

BC License Agreement 
BC Prerequisites 
Choose Install Folder 

* Storage Management Pla.. 

'" Host Cluster 

~' Pre-lnstallation Summary 

" Installing... 

A Additional Information 

n Install Complete 



InstallAnywhere by Zero G ■ 

Cancel 



Install Complete 



Congratulations! Business Copy Host Agent has been successfully 
installed to: 



/opt 



Press "Done" to quit the installer. 



Previous 



Done 



Figure 20: Install Complete 
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15. Click Done. 

The BC host agent software is now installed. This new BC-enabled host can now 
communicate with the BC server and participate in BC jobs. Refer to the BC Host Agent 
Release Notes before using BC. 
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Completing the installation 

If the BC host agent was started during installation, HP recommends browsing to the BC 
network and verifying that the BC host agent is recognized. Otherwise, perform the 
verification after manually starting the host agent. 

Completing the host agent installation topics include: 

■ Manually starting and stopping the Business Copy host agent 

■ Browsing to the Business Copy network 

■ Verifying that the BC host agent is recognized 

■ System files modified during installation and removal 

Manually starting and stopping the Business Copy host agent 

Refer to the BC Network Administration Guide for the procedures to manually start or stop 
service on a BC host agent. 

Browsing to the Business Copy network 

To browse to the BC network, the browsing computer must have a BC-supported browser and 
JRE installed. 

Refer to the BC Network Administration Guide and HP StorageWorks Business Copy 
EVA/MA/EMA 2.3 Server Release Notes (T3032-98201) for details. 

Verifying that the BC host agent is recognized 

To verify that a BC host agent is being recognized by the BC server platform, complete the 
following procedure: 

1. Browse to and log in to the BC server platform. 

The BC GUI displays. Refer to the BC Network Administration Guide, if necessary to 
access the BC GUI. 

2. Click Help. 

3. Click About Business Copy. 

Verify that the BC version number is 2.3. 

4. Click Resources. 

5. Review the Resources page to verify that this host is included in the host resources display. 
A successful installation displays the BC host agent on this page. 

6. Continue to the next host-specific BC Host Agent Installation Guide to add other BC host 
agents to this BC network or to update existing agents. 

System files modified during installation and removal 

During the BC host agent installation process, the following host computer system file is 
modified: /etc/services. 

Sample entries added to the /etc/services file include: 

switchboard 4991/tcp #CPQevm switchboard application 
bdctrcv 4995/udp #CPQevm broadcast receiver application 
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During the BC host agent removal process, this file is modified again to remove the BC entries 
that were added during the installation process. 
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Reinstalling the Business Copy 
Host Agent 



Situations may arise where a change in the BC network requires a change to BC server 
information stored by the BC host agent. For example: 

■ The BC server platform is renamed or replaced. 

■ The BC server platform IP address changes. 

■ The BC server software is moved to a different BC server platform. 

■ A network name changes. 

■ A host computer is reassigned for use with a different BC server platform. 
For these situations, reinstalling the BC host agent may be appropriate. 



A Caution: Make sure that all personnel involved with using storage systems associated with 
this BC environment are informed of the impending BC reinstallation. If not properly 
planned and coordinated, reinstalling a BC host agent while the host agent is involved in 
running a BC job can result in reduced operational capabilities and loss of data. 



Two reinstallation methods exist: 

■ One-step reinstallation — With this method, reinstall the BC host agent using "Installing 
the Business Copy Host Agent" on page 13. When prompted, allow the installation script 
to write over the existing host agent, and then install the BC host agent. 

■ Two-step reinstallation — With this method, remove the BC host agent using "Removing 
the Business Copy Host Agent" on page 33. Then reinstall the BC host agent using the 
procedure in "Installing the Business Copy Host Agent" on page 13. 

Reinstalling BC host agent software replaces only the BC files from the current installation. 
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Removing the Business Copy 
Host Agent 




Removing BC host agent software involves the following major steps: 

1. Coordinating removal activities, page 34 

2. Starting the removal, page 35 

3. Completing the removal, page 38 
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Coordinating removal activities 

Removing a BC host agent requires coordination to make sure that the software is removed 
cleanly from the host. 



A Caution: Make sure that all personnel using storage systems associated with this BC 
environment are informed of the impending BC removal. Removing a BC host agent while 
the host agent is running a BC job can result in reduced operational capabilities and loss of 
data. 



Ensure that: 

■ No BC jobs that involve the host are running or "undoing" during the removal 

■ No BC jobs that involve the host are scheduled to run or "undo" during the removal 

■ Removal activities have been coordinated with BC users and other operations 
Be aware that: 

■ Stopping a BC host agent prevents the host computer from being recognized by the BC 
network 

■ Stopping a BC host agent prevents any jobs involving that host from running successfully 
When ready, go to the next section. 



34 



Business Copy EVA/MA/EMA 2.3 Host Agent for Linux Installation Guide 



Removing the Business Copy Host Agent 



Starting the removal 

BC provides two removal methods for Linux: command console and GUI. 



Note: Do not use RPM to uninstall BC host agent software. RPM does not do a proper clean-up of 
BC during the removal process. 

Command console removal method 

Complete the following procedure to remove the BC host agent software from a host. 
Note: During the removal procedure, press Enter to choose the default response. 



1. Open a terminal window and log on as a super-user. 

2. Change the working folder to any folder other than the BC host agent folder. 



Note: HP recommends initiating the BC host agent removal from outside the BC host agent folder to 
prevent the display of errors during the removal. 



3. Enter /opt/CPQevm/UninstallerData/Uninstall_Business_Copy to 
initiate the removal script. 



Preparing CONSOLE Mode Installation 


Business Copy EVA / MA / EVA Host Agent v2 . 3 (created with 


InstallAnywhere by Zero G) 




About to uninstall. . . 




This will remove features installed by InstallAnywhere . 
folders created after the installation. 


It will not remove files and 


PRESS <ENTER> TO CONTINUE: 




Uninstalling . . . 


Uninstall Complete 




All items were successfully uninstalled. 





Figure 21 : BC removal status 

The command prompt returns when the BC host agent removal is complete. 
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GUI removal method 

Complete the following procedure to remove the BC host agent from a host. 

1. On the host computer, open a terminal window and log on as a super-user. 

2. Enter /opt/CPQevm/UninstallerData/ 
Uninstall_Business_Copy_v2 . 3_Host_Agent -i gui to initiate the 
removal. 



Note: Click Cancel at any time to exit setup. 



1 V. Uninstall Business Copy 






Uninstall Business Copy 


n Introduction 


About to uninstall... 


■ Uninstalling... 


Business Copy Host Agent 


■ Uninstall Complete 






This will remove features installed by InstallAnywhere. It will not 




remove files and folders created after the installation. 



InstallAnywhere by Zero G 



Cancel 

Figure 22: Uninstall Business Copy Host Agent 

3. Click Uninstall to uninstall the BC host agent software from the host. 

A Setup Status window is briefly displayed during the removal of BC files. File removal 
can take anywhere from a few seconds to several minutes. No action is required. 
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*@ Uninstall Business Copy 



'~' Introduction 

Uninstalling... 
" Uninstall Complete 



InstallAnywhere by Zero G ■ 

Cancel 



Uninstall Business Copy 



All items were successfully uninstalled. 



Previous 



Done 



Figure 23: Uninstall Business Copy host agent complete 
4. Click Done to exit setup. 

The BC host agent is now removed from this host computer. 
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Completing the removal 

After the BC host agent is removed, the computer can no longer participate in BC jobs. 
Running any BC job that involves this computer causes the job to fail. 

HP recommends planning for the disposition of each BC job that involves this computer. For 
example: 

■ Delete the job (if the job will not be valid again). 

■ Change the job (to eliminate all references to this host computer). 

■ Leave the job as is (if the job might be used again). 

From a BC network perspective, a BC host agent removal is not complete until all impacted 
BC jobs are resolved. 
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This glossary defines terms that are used in this guide or are related to BC. 

BC environment 

A SAN environment in which Business Copy replication features are available. BC features can be available 
through various means, such as: storage managers, BC server and jobs, BC host agents, command line 
interfaces, and script files. 

BC network 

The portion of a SAN that consists of a BC server connected via LAN to BC-enabled host computers. 
BC server platform 

An SMA or SMS with BC server software installed. 

See also Storage Management Appliance and Storage Management Server. 

daemon 

Diagnostic and Execution Monitor. Pronounced "demon." A program usually associated with a UNIX® system 
that performs a utility (housekeeping or maintenance) function without being requested or even known by the 
user. 

host 

In networked storage, a computer that can perform I/O with a storage array. In general networking, any 
computer on a network that provides a service. 

host agent 

In a client/server system, a program that performs information gathering or processes tasks on behalf of a client 
or server. Agents often communicate with other agents to perform a collective task on behalf of the user. 

host, BC-enabled 

A host computer that has BC host agent software installed. Compare to standard host, 
instance 

The presence of a program or set of related programs in a computer or storage system, 
job (BC job) 

A file created by BC that represents a user request to perform a task or series of tasks. For example, the BC job 
named sales_daily_backup might: 

1. Replicate virtual disks to create BCVs. 

2. Mount the BCV on a server. 

3. Start the tape backup of the BCV. Jobs can be created and run from the GUI, the BC command line 
(EVMCL), script files, or a scheduler. 



Business Copy EVA/MA/EMA 2.3 Host Agent for Linux Installation Guide 



39 



Glossary 



Open View 

An HP line of software products that provides storage management solutions, data protection and recovery, 
automatic performance tuning, storage virtualization, and other features for multivendor storage environments. 

SAN 

Storage Area Network. A dedicated, high-speed network of storage devices that are available to servers on a 
LAN or WAN. As storage devices are added to the SAN, they become accessible to the servers in the larger 
network. 

server 

A computer or program that provides a service to other computers in a client/server system. Servers often run 
continuously, waiting for requests from clients. 

SMA 

See Storage Management Appliance. 
SMS 

See Storage Management Server, 
storage manager 

A Web-based storage environment manager that enables a user to configure and monitor MA/EMA or EVA 
controllers. The HSG Element Manager resides on the Storage Management Appliance (SMA); Command View 
EVA resides on the BC server platform. 

Storage Management Appliance 

SMA. A host-independent server product designed to connect directly to the SAN fabric. The SMA provides a 
centralized point for managing and monitoring SAN elements, including HP switches and storage arrays. SMA 
software installed on the appliance provides a GUI interface for accessing the monitored SAN environment. The 
SMA software also provides a launch site for a variety of value-added HP OpenView applications and provides 
navigation links to directly manage storage components on the SAN. 

Storage Management Server 

SMS. Any HP supported hardware-software platform that is not connected to the SAN fabric and that does not 
serve as a storage host. SMS software installed on a platform provides a GUI interface for accessing the 
monitored SAN environment. 

StorageWorks 

An HP line of hardware and software storage solutions that provides storage management solutions, data 
protection and recovery, automatic performance tuning, storage virtualization, and other features for 
multivendor storage environments. 

unit (MA/EMA only) 

In StorageWorks storage systems, an identifier that the controller uses when a container is mounted on a host 
computer. For example, the unit identifier DI could represent a RAID 0+ 1 striped mirror set that is mounted on a 
host computer. StorageWorks disk units begin with the letter D and tape units begin with the letter T. 

virtual disk (EVA only) 

In StorageWorks storage systems, a simulated disk that is created from physical disks in a storage array for use 
by hosts. 
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